Doc additions

svn path=/trunk/; revision=21991

diff --git a/ChangeLog b/ChangeLog
index ec29044f68ee1b5a7fbf122aec8269a5143be3cc..a4a08b9dabfa9b1119aa2e6b5cd8c269d270a422 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2008-12-28  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkwidget.c: Document gtk_mnemonic_activate.
+
 2008-12-28  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtktextlayout.c: Un-doc-commentize non-public api

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index ff02b79a2c840c625ba6a367255064a60f2e509e..c451af390eafa5d6c0e4afcdbd318f1170dc00be 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -4434,6 +4434,19 @@ _gtk_widget_get_accel_path (GtkWidget *widget,
   return apath ? g_quark_to_string (apath->path_quark) : NULL;
 }
 
+/**
+ * gtk_widget_mnemonic_activate:
+ * @widget: a #GtkWidget
+ * @group_cycling:  %TRUE if there are other widgets with the same mnemonic
+ *
+ * Emits the #GtkWidget::mnemonic-activate signal.
+ * 
+ * The default handler for this signal activates the @widget if
+ * @group_cycling is %FALSE, and just grabs the focus if @group_cycling
+ * is %TRUE.
+ *
+ * Returns: %TRUE if the signal has been handled
+ */
 gboolean
 gtk_widget_mnemonic_activate (GtkWidget *widget,
                               gboolean   group_cycling)